home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / utils / disk / filemount / filemount.doc < prev    next >
Encoding:
Text File  |  1980-01-06  |  9.1 KB  |  258 lines

  1. FileMount V1.21
  2.  
  3.  
  4.  
  5. Copyright (C) 1993 by Dan Babcock
  6.  
  7. Freely redistributable for non-commercial purposes
  8.  
  9.  
  10.  
  11. Introduction
  12.  
  13.  
  14.  
  15.     FileMount is a simple utility designed to create what I call 
  16. "pseudo-partitions". A pseudo-partition has all the characteristics of a real 
  17. partition, but resides within a file. Now, this begs the question, "what is a 
  18. partition"? On the Amiga a partition is simply a set of contiguous sectors on 
  19. a disk. A file on the other hand is not required to comprise only contiguous 
  20. sectors; each data block may reside anywhere on the disk. To bridge this 
  21. gap various people have written device drivers that operate on files, for 
  22. example FMS by Matt Dillon or FDEV by Timo Rossi. They do a good job, 
  23. but have some disadvantages. For one, they are slow compared to a real 
  24. partition. What's worse, though, is that you can't use them with AMAX, or 
  25. other operating systems, because AmigaDOS won't be around to access 
  26. the file.
  27.  
  28.     FileMount takes a different approach, creating a file composed of 
  29. only contiguous blocks, which can then be used like a true partition. 
  30. Compared to a "real" partition, you have a couple big advantages: you 
  31. don't need to backup/partition/restore (although some steps may need to 
  32. be taken if your hard drive is highly fragmented) and you can recover the 
  33. space simply by deleting the file.
  34.  
  35.  
  36.  
  37. Limitations
  38.  
  39.  
  40.  
  41.     FileMount requires Kickstart 2.04 or higher.
  42.  
  43.     FileMount is designed for use on Fast File System (FFS) partitions 
  44. *ONLY*. Trying to use it on a partition using some other file system WILL 
  45. corrupt your data. So don't try it.
  46.  
  47.  
  48.  
  49. Changes
  50.  
  51.  
  52.  
  53.     V1.10 fixes a major flaw of 1.00: various important MountList 
  54. parameters such as MaxTransfer are now inherited from the host partition, 
  55. rather than being hard-coded into FileMount. This isn't important for AMAX, 
  56. but is very important for FFS or CrossDOS usage.
  57.  
  58.     V1.20 works around a rather devastating bug in the Fast File 
  59. System. FFS only observs the lower 16-bits of lowcyl/highcyl, and so if the 
  60. pseudo-partition happened to start more than 32MB into the disk FFS 
  61. would stomp over a random portion of the drive instead of the part 
  62. specified by FileMount. In this version the pseudo-partition is always 
  63. placed on a 128-block boundary, and the "BlocksPerTrack" is set to 128 
  64. (except in the case of CrossDOS or when the highcyl is under 65536). This 
  65. may, depending upon the situation, invalidate an AMAX partition created 
  66. with an earlier version of FileMount. This is regrettable, but the change had 
  67. to be made.
  68.  
  69.     V1.21 - Added "NoActivate" option.
  70.  
  71.  
  72.  
  73. Usage
  74.  
  75.  
  76.  
  77.     FileMount is usable from the CLI only. Type "filemount ?" to see the 
  78. command line options. It has two modes of operation, CREATE and 
  79. MOUNT.
  80.  
  81.  
  82.  
  83. CREATE:
  84.  
  85.  
  86.  
  87.     The CREATE option takes a filename for the pseudo-partition file 
  88. that you wish to create. The name of the file (apart from the directory path) 
  89. will be the device name when you use the MOUNT option (described 
  90. below). Along with the filename, there is a mandatory SIZE parameter 
  91. which specifies the size of the pseudo-partition in kilobytes. Examples:
  92.  
  93.  
  94.  
  95. To create an AMAX partition of 15MB:
  96.  
  97.     filemount create devs:amax size 15000
  98.  
  99. To create a CrossDOS partition of 5MB:
  100.  
  101.     filemount create devs:pcc size 5000
  102.  
  103.  
  104.  
  105.     Assuming everything proceeded successfully, you should see some 
  106. information printed including the starting and ending block numbers of the 
  107. pseudo-partition. If you wanted, you could use this information to construct 
  108. a MountList entry or a mount file. Normally, however, you will want to use 
  109. the automatic mounting facility of FileMount, in which case you don't have 
  110. to worry about anything.
  111.  
  112.     If your hard drive is highly fragmented, you may lack sufficient 
  113. contiguous space for the pseudo-partition. You might choose to run a disk 
  114. defragmentation utility (heeding the warnings given elsewhere if you 
  115. already have pseudo-partitions installed) or go through a backup/restore 
  116. cycle.
  117.  
  118.     The file created with CREATE will be delete-protected for your 
  119. safety. If you really want to delete it either use Workbench or the CLI's 
  120. PROTECT command to enable deletion. After deleting the file, REBOOT 
  121. YOUR SYSTEM IMMEDIATELY (the reason is, if you accidentally use the 
  122. pseudo-partition that you just deleted, your main partition will be 
  123. corrupted).
  124.  
  125.  
  126.  
  127. WARNING! The CREATE option operates at the device level and *IF* there 
  128. is a bug in this code it would have the potential to corrupt your hard drive. 
  129. On the other hand, if your hard drive does not validate successfully after 
  130. using CREATE, it isn't necessarily the fault of this program - your hard 
  131. drive may have been corrupt already without you knowing it. In fact, this 
  132. happened to me during the development of FileMount: my hard drive was 
  133. "corrupted" after running FileMount, and since the code was basically 
  134. untested, I assumed a bug in FileMount. I later found out that FileMount 
  135. had in fact worked perfectly but that my hard drive was corrupted 
  136. beforehand due to an incorrect MountList for my AMAX partition.
  137.  
  138.  
  139.  
  140. As an aside, this utility has been around long enough that I consider it 
  141. "safe"; however it is the nature of software to surprise the user (and 
  142. programmer) at the most inopertune moment.
  143.  
  144.  
  145.  
  146. MOUNT:
  147.  
  148.  
  149.  
  150.     The mount option activates the pseudo-partition and makes it known 
  151. to AmigaDOS. You should place the appropriate "filemount mount" 
  152. commands in your startup-sequence or user-startup files to automatically 
  153. mount the partitions each time you boot. (Note: FileMount is "pure" and you 
  154. may want to make it temporarily resident if you need to mount multiple 
  155. pseudo-partitions). The MOUNT option takes as its argument the 
  156. path/name of the file that you created earlier with the CREATE option. The 
  157. name of the mounted device will be the same as the filename (excluding 
  158. the path, of course). You only have two options for mounting the file: either 
  159. for Fast File System (FFS), which will also work for AMAX, or for 
  160. CrossDOS (either the version supplied with 2.1/3.0 of the OS or V5 of the 
  161. full commercial version). FFS is the default. If you want the partition 
  162. mounted for use with CrossDOS/CrossPC, specify the CROSSDOS option. 
  163. New for V1.21: There is a "NoActivate" option which mounts the device 
  164. without starting the file system. This can be used to avoid unsightly icons 
  165. on your Workbench (e.g. for your AMAX partition). The "NoActivate" option 
  166. may also be useful with PCTask (last time I played with PCT it didn't 
  167. understand how to deal with a CrossDOS-mounted partition). Examples:
  168.  
  169.  
  170.  
  171. To mount the file "devs:DH1" for FFS:
  172.  
  173.     filemount mount devs:dh1
  174.  
  175.  
  176.  
  177. To mount the file "devs:AMAX" for AMAX:
  178.  
  179.     filemount mount devs:amax noactivate
  180.  
  181.  
  182.  
  183. To mount the file "devs:PCC" for use with CrossDOS/CrossPC:
  184.  
  185.     filemount mount devs:pcc crossdos
  186.  
  187. IMPORTANT INFO: The CROSSDOS option always mounts the 
  188. pseudo-partition with a DOSTYPE of "MSH". That tells CrossDOS that the 
  189. pseudo-partition is an MS-DOS hard drive ("MSD" would indicate a floppy). 
  190. Clearly then, you can't simulate an MS-DOS floppy (no big deal). Rather, it 
  191. is intended for the use of CrossPC or PC-Task. You can not format the 
  192. CrossDOS partition with the AmigaDOS Format command!!! (The 
  193. AmigaDOS format will only format "MSD" devices because it can't do the 
  194. job of FDISK). You must run the MS-DOS program FDISK under 
  195. CrossPC/PC-Task to create a partition on your simulated MS-DOS hard 
  196. drive, and then use the MS-DOS Format command (don't forget the /S 
  197. option to install system files!) to format the MS-DOS hard drive partition. 
  198. Then and only then will you be able to read from and write to the partition 
  199. with CrossDOS. ALSO NOTE: The CrossDOS partition name MUST end in 
  200. the letter "C"!!! (The last letter corresponds to the MS-DOS partition. 
  201. FileMount only allows you to mount one MS-DOS partition per 
  202. pseudo-partition, so the letter will always be "C").
  203.  
  204.  
  205.  
  206.     The MOUNT option automatically checks the file for integrity and will 
  207. refuse to mount if the pseudo-partition has been corrupted (that is, if the file 
  208. no longer comprises only contiguous blocks). This protects your main 
  209. Amiga partition.
  210.  
  211.  
  212.  
  213. !!!WARNINGS!!!
  214.  
  215. !!!PLEASE READ!!!
  216.  
  217.  
  218.  
  219.     FileMount is a somewhat "dangerous" utility is the sense that it 
  220. requires some responsibility from the user. Failing to adhere to these 
  221. precautions can be hazardous to your data.
  222.  
  223.     First and foremost, any time you copy the pseudo-partition file 
  224. somewhere (during a hard drive backup, for example), you should assume 
  225. all the data in the partition (that is, in the backup of the partition) to be lost. 
  226. Now, that's not to say that the data is impossible to restore, but it's 
  227. inconvenient. (One method would be to create a new filemount partition of 
  228. _exactly_ the same size and then COPY (normal CLI copy command) from 
  229. the file that represents the restored partition to the fresh partition. I have 
  230. not actually tried this however...)
  231.  
  232.     Using a disk defragmentation utility will (in many cases) corrupt the 
  233. pseudo-partitions!
  234.  
  235.     It is safe to rename the pseudo-partition file.
  236.  
  237.  
  238.  
  239. The Author
  240.  
  241.  
  242.  
  243.     I can be reached at d6b@ecl.psu.edu.
  244.  
  245.  
  246.  
  247.     Other fine freeware software products by me:
  248.  
  249.  
  250.  
  251.     QMouse: A small multi-functional "mouse utility" with a unique set of 
  252. features
  253.  
  254.     Hackdisk: A trackdisk.device replacement offering a verify option
  255.  
  256.  
  257.  
  258.